home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / utility / zdir20.zip / ZDIR.DOC < prev    next >
Text File  |  1992-03-04  |  76KB  |  1,981 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                     ZANYSOFT DIR
  13.  
  14.                                      Version 2.0
  15.  
  16.                                     March 4, 1992
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                  Christopher Kirmse 
  25.                                       ZanySoft
  26.                                   9303 Arabian Ave.
  27.                                Vienna, Virginia  22182
  28.  
  29.                                  _______
  30.                             ____|__     |               (R)
  31.                          --|       |    |-------------------
  32.                            |   ____|__  |  Association of
  33.                            |  |       |_|  Shareware
  34.                            |__|   o   |    Professionals
  35.                          -----|   |   |---------------------
  36.                               |___|___|    MEMBER
  37.  
  38.                      Copyright (C) 1990, 1992 Christopher Kirmse
  39.                                  All rights reserved
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                   Table of Contents
  74.  
  75.      1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  76.           1.1 Features . . . . . . . . . . . . . . . . . . . . . . . . . .    1
  77.           1.2 Terms in this manual . . . . . . . . . . . . . . . . . . . .    2
  78.  
  79.      2. Using shareware  . . . . . . . . . . . . . . . . . . . . . . . . .    3
  80.           2.1 Disclaimer - agreement . . . . . . . . . . . . . . . . . . .    3
  81.           2.2 Contacting the author  . . . . . . . . . . . . . . . . . . .    4
  82.  
  83.      3. Quick-start  . . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  84.  
  85.      4. Running ZDir . . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  86.           4.1 The file listing . . . . . . . . . . . . . . . . . . . . . .    7
  87.           4.2 Path specification . . . . . . . . . . . . . . . . . . . . .    9
  88.                4.2.1 Displaying path specs . . . . . . . . . . . . . . . .   11
  89.           4.3 Volume information . . . . . . . . . . . . . . . . . . . . .   12
  90.  
  91.      5. ZDir options . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  92.           5.1 Information options  . . . . . . . . . . . . . . . . . . . .   13
  93.           5.2 Command options  . . . . . . . . . . . . . . . . . . . . . .   13
  94.                5.2.1 Write to file . . . . . . . . . . . . . . . . . . . .   13
  95.                5.2.2 File find . . . . . . . . . . . . . . . . . . . . . .   14
  96.                5.2.3 Tree display  . . . . . . . . . . . . . . . . . . . .   15
  97.                5.2.4 User extensions . . . . . . . . . . . . . . . . . . .   16
  98.                5.2.5 Attribute changing  . . . . . . . . . . . . . . . . .   17
  99.           5.3 File listing options . . . . . . . . . . . . . . . . . . . .   17
  100.  
  101.      6. Configuration:  ZDircfg  . . . . . . . . . . . . . . . . . . . . .   19
  102.           6.1 Using ZDircfg  . . . . . . . . . . . . . . . . . . . . . . .   19
  103.           6.2 ZDircfg menus  . . . . . . . . . . . . . . . . . . . . . . .   20
  104.                6.2.1 Load ZDir configuration . . . . . . . . . . . . . . .   20
  105.                6.2.2 Save ZDir configuration . . . . . . . . . . . . . . .   21
  106.                6.2.3 Extension editing . . . . . . . . . . . . . . . . . .   21
  107.                6.2.4 Color editing . . . . . . . . . . . . . . . . . . . .   22
  108.                6.2.5 Default editing . . . . . . . . . . . . . . . . . . .   23
  109.                     6.2.5.1 Search options . . . . . . . . . . . . . . . .   23
  110.                     6.2.5.2 File list choices  . . . . . . . . . . . . . .   24
  111.                     6.2.5.3 Output format  . . . . . . . . . . . . . . . .   26
  112.  
  113.      7. Registration form  . . . . . . . . . . . . . . . . . . . . . . . .   28
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.                                           i
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      1. Introduction
  140.  
  141.      ZanySoft Dir (ZDir) is an easy to use and very powerful directory lister. 
  142.      The main purpose of ZDir is to replace the generic DIR command with a
  143.      fast, easily readable display with more functionality.  It can organize
  144.      the file listing with many sorting options, color files based upon their
  145.      extension, choose how many columns to use in the display, find files, draw
  146.      a tree of the directory structure, use full-scale wildcards, and much
  147.      more.  Besides being powerful and easy to use, ZDir is also easy to
  148.      configure with the included configuration program ZDircfg.  It is very
  149.      easy for a novice computer user to learn how to use ZDir, but has many
  150.      features that expand upon the basic directory listing capability.
  151.  
  152.      Everything about ZDir is explained in this manual.  Even if you are not
  153.      interested in reading it all now, at least look at section 3, the quick-
  154.      start.  It is a general overview of how to use ZDir and what it does, and
  155.      only takes a couple minutes to read.
  156.  
  157.  
  158.  
  159.      1.1 Features
  160.  
  161.      The following list shows some of the many features of ZDir:
  162.  
  163.      o    It is extremely fast.
  164.  
  165.      o    It is fully configurable--every color, extension, and default is set
  166.           by the user.
  167.  
  168.      o    It colors each filename based upon its attribute and extension.
  169.  
  170.      o    It sorts the listing by filename, extension, size, date, and time,
  171.           ascending or descending.
  172.  
  173.      o    It can group directory entries at the beginning or end of the
  174.           display.
  175.  
  176.      o    It can search for files anywhere on a disk.
  177.  
  178.      o    Wildcards may be placed anywhere in the filespec and are correctly
  179.           interpreted.
  180.  
  181.      o    It gives totals for all found files at the end of the display.
  182.  
  183.      o    It can color all information about each file the same color.
  184.  
  185.      o    It can write a plain-text version of the listing to a file or to the
  186.           printer.
  187.  
  188.      o    It prints out the current date and time at the top of the display.
  189.  
  190.      o    It shows the volume label and serial number, if they exist.
  191.  
  192.                                           1
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      o    It fully supports any size text screen that your video card supports,
  206.           including 43/50 line mode on EGA/VGA systems.
  207.  
  208.      o    It is extremely small--even with all these features, it is less than
  209.           13k in size.
  210.  
  211.  
  212.  
  213.      1.2 Terms in this manual
  214.  
  215.      Several conventions are used in this manual, and they are described as
  216.      follows:
  217.  
  218.      o    The Enter or Return key on the keyboard is referred to as <Enter>.
  219.  
  220.      o    All text that is meant to be typed by the user is in bold type.
  221.  
  222.      o    Text printed on the screen by the computer is in courier type.
  223.  
  224.      o    The terms "window", "box", and "menu" are used somewhat
  225.           interchangeably in this manual, but the actual meaning should be
  226.           clear from the context.
  227.  
  228.      o    Menu sequences in ZDircfg are in italics and referred to by name,
  229.           with -> separating each menu level, such as Default edit->Search
  230.           options->Put * before filespec, where Default edit is the first menu
  231.           choice, Search options is the second menu choice, and Put * before
  232.           filespec is the third menu choice.
  233.  
  234.      o    Some of these conventions are not detectable in the online version of
  235.           the manual.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                           2
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.      2. Using shareware
  272.  
  273.      Shareware distribution gives users a chance to try software before buying
  274.      it. If you try a Shareware program and continue using it, you are expected
  275.      to register. Individual programs differ on details--some request
  276.      registration while others require it, some specify a maximum trial period.
  277.      With registration, you get anything from the simple right to continue
  278.      using the software to an updated program with printed manual.
  279.  
  280.      Copyright laws apply to both Shareware and commercial software, and the
  281.      copyright holder retains all rights, with a few specific exceptions as
  282.      stated below. Shareware authors are accomplished programmers, just like
  283.      commercial authors, and the programs are of comparable quality. (In both
  284.      cases, there are good programs and bad ones!) The main difference is in
  285.      the method of distribution. The author specifically grants the right to
  286.      copy and distribute the software, either to all and sundry or to a
  287.      specific group. For example, some authors require written permission
  288.      before a commercial disk vendor may copy their Shareware.
  289.  
  290.      Shareware is a distribution method, not a type of software. You should
  291.      find software that suits your needs and pocketbook, whether it's
  292.      commercial or Shareware. The Shareware system makes fitting your needs
  293.      easier, because you can try before you buy. And because the overhead is
  294.      low, prices are low also. Shareware has the ultimate money-back
  295.      guarantee--if you don't use the product, you don't pay for it.
  296.  
  297.  
  298.  
  299.      2.1 Disclaimer - agreement
  300.  
  301.      Users of ZDir must accept this disclaimer of warranty:  "ZDir is supplied
  302.      as is.  The author disclaims all warranties, expressed or implied,
  303.      including, without limitation, the warranties of merchantability and of
  304.      fitness for any purpose. The author assumes no liability for damages,
  305.      direct or consequential, which may result from the use of ZDir."
  306.  
  307.      ZDir is a "shareware program" and is provided at no charge to the user for
  308.      evaluation.  Feel free to share it with your friends, but please do not
  309.      give it away altered or as part of another system.  The essence of
  310.      "user-supported" software is to provide personal computer users with
  311.      quality software without high prices, and yet to provide incentive for
  312.      programmers to continue to develop new products.
  313.  
  314.      If you find this program useful and find that you are using ZDir and
  315.      continue to use ZDir after a reasonable trial period, you must make a
  316.      registration payment of $10 to Christopher Kirmse.  The $10 registration
  317.      fee will license one copy for use on any one computer at any one time. 
  318.      You are then authorized to use your copy forever; it is as if you had
  319.      bought it at a store.  Anyone else may use your copy of ZDir, but only on
  320.      a trial basis.  Also, your registration name and number sent to you when
  321.      you register is for you only, and only you may use it.  To register ZDir,
  322.      just fill out the registration form in section 7 at the end of this
  323.  
  324.                                           3
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.      document, and send it in.  Every registered user of ZDir will receive a
  338.      minimum of three months of support through the mail.
  339.  
  340.      If your version of ZDir did not come with the following files, then it is
  341.      not the official version of ZDir:  ZDir.com, ZDir.doc, ZDircfg.exe, and
  342.      Readme.doc.  If your version of ZDir is not complete, please contact
  343.      whoever you received it from to remove it from their system.  To guarantee
  344.      that you have the latest and complete version of ZDir, either send a
  345.      note and $5 (see section 7--you don't need to register to get a disk), or
  346.      preferably, call up CompuServe or The Palace BBS and download ZDirxy.zip,
  347.      where x.y would be the version number.  See section 2.2 for details.
  348.  
  349.      Commercial users of ZDir must register and pay for their copies of ZDir
  350.      within 30 days of first use or their license is withdrawn.  Site-license
  351.      arrangements may be made by contacting Christopher Kirmse.  The standard
  352.      site-license is $10 for each of the first ten copies of ZDir, and $5 for
  353.      every additional copy at the same site.
  354.  
  355.      You are encouraged to pass a copy of ZDir along to your friends for
  356.      evaluation.  Please encourage them to register their copy if they find
  357.      that they can use it.
  358.  
  359.      Christopher Kirmse is a member of the Association of Shareware
  360.      Professionals (ASP).  ASP wants to make sure that the shareware principle
  361.      works for you. If you are unable to resolve a shareware-related problem
  362.      with an ASP member by contacting the member directly, ASP may be able to
  363.      help. The ASP Ombudsman can help you resolve a dispute or problem with an
  364.      ASP member, but does not provide technical support for members' products. 
  365.      Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442
  366.      or send a CompuServe message via CompuServe Mail to ASP Ombudsman
  367.      70007,3536.
  368.  
  369.      All trademarks referenced in this document are the property of their
  370.      respective owners.
  371.  
  372.  
  373.  
  374.      2.2 Contacting the author
  375.  
  376.      There are several ways to contact Christopher Kirmse, the author of ZDir. 
  377.      The easiest way is through the US postal service--write to the address on
  378.      the first page of this document.  He can also be contacted through
  379.      Internet, at the address ckirmse@thor.tjhsst.edu.  The newest version of
  380.      ZDir will always be on CompuServe and on The Palace BBS, phone number
  381.      (703) 866-4452.
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.                                           4
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.      3. Quick-start
  403.  
  404.      To get a feel for how to use ZDir, just type ZDir at the DOS prompt
  405.      (typically C> or C:\>).  It will instantly display a listing of the files
  406.      in the current directory.  Assuming that the copy of ZDir used has the
  407.      initial defaults, the display will look something like the following:
  408.  
  409. 1:52:04pm                    ZDir v2.0, by ZanySoft            January 21, 1991
  410. Path: C:\*.*                                                    Volume - HOME 1
  411. ═══════════════════╤═══════════════════╤═══════════════════╤═══════════════════
  412. 123R3         <Dir>│GAMES         <Dir>│V3            <Dir>│COMMAND  PIF    545
  413. BAT           <Dir>│JUNK          <Dir>│WINAPP        <Dir>│CONFIG   BAK   1480
  414. BCPP          <Dir>│LABEL         <Dir>│WINDOWS       <Dir>│CONFIG   SYS   1697
  415. BOB           <Dir>│LASM          <Dir>│WP            <Dir>│HIMEM    SYS  11304
  416. C600          <Dir>│NEWSTER       <Dir>│ZD86          <Dir>│IBMBIO   COM  17867
  417. CASTLE        <Dir>│PBRUSH        <Dir>│ZDIR          <Dir>│IBMDOS   COM  40082
  418. CHRIS         <Dir>│Q             <Dir>│386SPART PAR   5.1M│HOME 1        <Vol>
  419. CTR           <Dir>│SA            <Dir>│AUTOEXEC BAK    297│
  420. DOWNLOAD      <Dir>│TAXI          <Dir>│AUTOEXEC BAT    285│
  421. DRDOS         <Dir>│UTILS         <Dir>│COMMAND  COM  32816│
  422. ═══════════════════╧═══════════════════╧═══════════════════╧═══════════════════
  423.     10 files totalling 5,226,373 bytes using 5,236,736 bytes of disk space.
  424.       17,555,456 bytes available out of 88,842,240 total bytes on drive C: 
  425.  
  426.      The first line contains the current time, a message telling the current
  427.      ZDir version, and the current date.  The second line shows the path
  428.      specification of the files listed (described in detail in section 4.2). 
  429.      On the right side of the second line the volume label and serial number
  430.      are displayed, it they exist.  In this case, there is a volume label, but
  431.      no serial number.
  432.  
  433.      The main area of the display is surrounded by graphic lines.  It contains
  434.      the list of the files which matched the file specification, in this case
  435.      *.*.  As a default, all the directories are listed first, sorted by the
  436.      directory name, followed by the files, sorted by name.  In the default
  437.      setting ZDir adjusts the number of columns in the display based upon the
  438.      number of directories and files in the directory, and in this case ZDir
  439.      decided to display the listing in four columns.  Your display may be
  440.      different if you have more or less files in the listed directory.  In four
  441.      column listings, only the filename and file size are listed.  Notice the
  442.      size of the file 386SPART.PAR file--5.1M.  This means 5.1 Megabytes, or
  443.      5,100,000 bytes.  This is truncated at the tenth's place.  When not
  444.      displaying the listing in one column, all file sizes larger than 1 million
  445.      bytes are printed in this manner.
  446.  
  447.      The final two lines of the display give totals information.  The first
  448.      summary line tells how many files were listed (optionally including
  449.      directories), the sum of all the file sizes, and how much disk space the
  450.      files actually consume on the disk.  The second line (which can be
  451.      optionally not printed) shows how much free space is left on the disk and
  452.      the total storage amount of the disk that the files were listed from.
  453.  
  454.      ZDir can be used as a straight replacement of the DOS DIR command, but to
  455.  
  456.                                           5
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.      take full advantage of its power you need to learn how to use its many
  469.      features.  Advanced users can probably learn how to use ZDir by trial and
  470.      error and by referring to the help screen (type ZDir /? to display the
  471.      help screen).  This manual describes how to use all the features of ZDir,
  472.      including configuring ZDir with ZDircfg, and is useful for anyone learning
  473.      about ZDir.
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.                                           6
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.      4. Running ZDir
  536.  
  537.      The technical description for running ZDir is 
  538.  
  539.           ZDir [options] [path spec] [options]
  540.  
  541.      The items in brackets are optional.  This means that the simplest way to
  542.      run ZDir is just to type ZDir from the command line:
  543.  
  544.      C:\>ZDir<Enter>
  545.  
  546.      (<Enter> means to hit the Enter or Return key on the keyboard.)
  547.  
  548.      Options are single letters preceded by a forward slash (/), such as /T or
  549.      /U.  The path spec and options can be typed in upper or lower case; ZDir
  550.      is not case sensitive.  Options are described in section 5.  The entire
  551.      string of text following the word ZDir is called the command line.  In the
  552.      following example, the command line is  /u *.exe /1 /x:
  553.  
  554.      C:\>ZDir /u *.exe /1 /x<Enter>
  555.  
  556.      Usually it is easier to put the options all together, either before or
  557.      after the path spec, but they can be split up and put in both places.
  558.  
  559.      ZDir displays a file listing with header information and total lines
  560.      unless there is the option /? or /H on the command line.  The display
  561.      works in any text mode, including Super VGA text modes such as 132x60.  If
  562.      the screen is in a standard graphics mode, then ZDir resets the screen to
  563.      25 rows by 80 columns.  Super VGA graphic modes are not standard and
  564.      cannot be detected, so ZDir will not print a correct display if the screen
  565.      is in a Super VGA graphics mode.  ZDir will work with any display,
  566.      including monochrome, CGA, EGA, VGA, Super VGA, and XGA.
  567.  
  568.  
  569.  
  570.      4.1 The file listing
  571.  
  572.      The main area of the display is a listing of filenames, directory names,
  573.      and if it exists, the volume label.  For the rest of this section, the
  574.      terms file and filename are used in a generic sense, meaning every
  575.      directory entry, including not only names of files but directories and
  576.      volume labels as well.  The most trivial display is when there are no
  577.      files, in which case ZDir prints No files found in the main area of the
  578.      display.  In every other case, the display is separated into either 1, 2,
  579.      3, 4, or 6 columns.  The number of columns is determined by the
  580.      configuration setting Default edit->File list choices->Number of columns,
  581.      discussed in section 6.2.5.2, and the command line, discussed in section
  582.      5.3.
  583.  
  584.      The number of columns that are used to display the file listing determines
  585.      what information is given about each file.  Obviously, as the number of
  586.      columns across the screen increases, the amount of information about each
  587.  
  588.                                           7
  589.  
  590.  
  591.  
  592.  
  593.     
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.      file decreases.  In one column mode, everything about the file is shown,
  601.      with plenty of room for large file sizes with commas, and the time in 12-
  602.      hour format with seconds.  In six column mode, there is nothing except the
  603.      filename.  The following chart shows what is included depending upon the
  604.      number of columns used in the display:
  605.  
  606.                        ╔═══════════════════════════════════════════╗
  607.     ╔══════════════════╣             Number of columns             ║
  608.     ║ File information ║  1       2         3         4        6   ║
  609.     ╟──────────────────┼──────┬────────┬─────────┬─────────┬───────╢
  610.     ║ Name             │ Yes  │  Yes   │   Yes   │   Yes   │  Yes  ║
  611.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  612.     ║ Size             │ Yes  │  Yes   │   Yes   │   Yes   │  No   ║
  613.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  614.     ║ Attribute        │ Yes  │  Yes   │   Yes   │   No    │  No   ║
  615.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  616.     ║ Date and time    │ Yes  │  Yes   │   No    │   No    │  No   ║
  617.     ╟──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  618.     ║ Disk space       │ Yes  │  No    │   No    │   No    │  No   ║
  619.     ║ used             │      │        │         │         │       ║
  620.     ║──────────────────┼──────┼────────┼─────────┼─────────┼───────╢
  621.     ║ Commas in        │ Yes  │  No    │   No    │   No    │  No   ║
  622.     ║ file sizes       │      │        │         │         │       ║
  623.     ║ 100,000 bytes    │      │        │         │         │       ║
  624.     ╚══════════════════╧══════╧════════╧═════════╧═════════╧═══════╝
  625.  
  626.      For commas to be printed in file sizes   100,000 bytes, the option Default
  627.      edit->Output format->Use commas in file size must be set to yes.
  628.  
  629.      The filename is printed in two parts:  the normal part of the filename
  630.      which can be up to eight characters in length, left justified in a field
  631.      of eight spaces, followed by a space or a period (depending on the setting
  632.      of Default edit->Output format->Print a . before extensions), followed by
  633.      the up to three character extension.  The color of the filename is based
  634.      upon whether the file is a hidden file and whether the extension matches
  635.      any of the fifty set extensions (see section 6.2.3).
  636.  
  637.      ZDir stores a table of fifty extensions and associated colors that it
  638.      matches against each file.  If a file's extension matches one of the
  639.      extensions in the table, then the file is displayed in the color
  640.      associated with the extension.  Wildcards are allowed in the stored
  641.      extensions, which are configured using ZDircfg.  If the file is actually a
  642.      directory or if it is hidden, then the directory color or hidden color
  643.      overrides the extension color and the file is not displayed in the
  644.      extension color.  Depending on the setting of Default edit->File list
  645.      choices->Entire entry in file color the rest of the directory entry is
  646.      automatically displayed in the same color as the filename or in the color
  647.      selected for each part of the directory entry.
  648.  
  649.      File sizes are printed in every column mode except in six column mode. 
  650.      They are displayed in either the same color as the file or in the color
  651.      set in Color edit->File entry area->Size of file, depending on whether the
  652.      entire file entry is the color of the file (set in Default edit->File list
  653.  
  654.                                           8
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.      choices->Entire entry in file color).  If commas are set to be printed in
  668.      file sizes, then if the file size is five or fewer digits (i.e., less than
  669.      100,000 bytes), then a comma separates the thousands from the hundreds
  670.      place.  In one column mode, no matter what the file size, if commas are
  671.      set to be added to file sizes, then commas separate every three digits of
  672.      file sizes.  In any other column mode, file sizes 1,000,000 bytes and
  673.      larger are displayed in terms of megabytes (one million bytes), such as
  674.      1.2M or 84.5M.
  675.  
  676.      The attributes of each file are displayed in one, two, and three column
  677.      mode.  The five attributes are described in section 5.2.5, but in short
  678.      are archive, hidden, read-only, system, and network.  They are abbreviated
  679.      in the display with the first letter--A, H, R, S, and N.  They are
  680.      displayed in either the same color of the file or in the color set in
  681.      Color edit->File entry area->Attributes.  (In two column mode, the network
  682.      attribute touches the date if the month is two digits long (October,
  683.      November, and December), because of lack of space.)
  684.  
  685.      Every time that a file is written to, the date and time are saved with the
  686.      file by DOS.  ZDir displays the most recent access date and time in one
  687.      and two column modes.  The colors are determined by the setting in Color
  688.      edit->File entry area->Date and Time, and whether or not the entire file
  689.      entry is in the filename's color.  In one column mode, the time is
  690.      displayed in 12 hour mode with an "a" or a "p" after the seconds
  691.      signifying AM or PM.  In two column mode, the time is in 24 hour mode, and
  692.      the seconds are not printed.  The dates are the same in either number of
  693.      columns.
  694.  
  695.      In one column mode, the actual space on disk used by each file is placed
  696.      after the file size, in the color specified by Color edit->File entry
  697.      area->Used disk space of file, or the color of the filename if the entire
  698.      entry is in the filename's color.  To understand the difference between
  699.      this number and the file size, the method of storing files on disk has to
  700.      be explained.
  701.  
  702.      Files are stored on disk as a chain of clusters, each of which contains
  703.      part of the file.  The disk has a table which keeps track of which
  704.      clusters belong to which files, and in what order.  Clusters are of fixed
  705.      length on each disk, as small as 512 bytes and as large as 8192 bytes. 
  706.      Because of the fact that clusters can belong to only one file, every file
  707.      contains an integral number of clusters.  This means that most files, not
  708.      being a multiple in size of the cluster size, use up more disk space than
  709.      their actual size.  This accounts for the difference in the file size and
  710.      the disk space used by a file.  The total lines at the bottom show both
  711.      the file sizes and the file disk space used.
  712.  
  713.  
  714.  
  715.      4.2 Path specification
  716.  
  717.      The path specification determines how ZDir searches the disk to determine
  718.      which files to include in the file listing.  It contains three parts:  the
  719.  
  720.                                           9
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.      disk drive, the path, and the file specification, called the filespec. 
  734.      The path specification can be no longer than 63 characters, the maximum
  735.      that DOS allows.
  736.  
  737.      The disk drive is a letter followed by a colon--A:, C:, H:, etc.  A: and
  738.      B: are usually floppy disk drives, C: is usually the first hard disk,
  739.      while higher letters can be anything from a RAM disk to a CD-ROM to a
  740.      network drive.  If the disk drive is typed as part of the path
  741.      specification, then it is used in the search.  If it is omitted from the
  742.      path specification, then the current disk drive is used.
  743.  
  744.      The path is a string of directories and subdirectories, separated by
  745.      backslashes (\).  If the path starts with a backslash, then the rest of
  746.      the string is relative to the root, or top-level, directory on the drive. 
  747.      If it does not start with a backslash, then the rest of the string is
  748.      relative to the current directory on the disk drive.  If no path is
  749.      specified in the path specification at all, then the current directory is
  750.      used.
  751.  
  752.      Like filenames, the filespec consists of two parts, the "normal" filename,
  753.      which is one to eight characters long, and the extension, which is zero to
  754.      three characters in length.  Letters of the alphabet and some symbols
  755.      (such as !, $, and greek letters) are valid characters in the filespec. 
  756.      Filespecs, and in fact all DOS filenames, are not case sensitive.  If only
  757.      these alphabetic and symbol characters are part of the filespec, then ZDir
  758.      will either match one file or not match any files, because either a file
  759.      by that name exists or it does not.  To make a listing include more than
  760.      one file the filespec must contain special characters called wildcards.
  761.  
  762.      The wildcards characters are the asterisk, *, and the question mark, ?. 
  763.      They can be placed in the "normal" part of the filespec, in the extension,
  764.      or both.  The question mark matches all files that have any single
  765.      character in the place of the question mark, or none at all.  The asterisk
  766.      tells ZDir to match all files that have any string of characters in place
  767.      of the asterisk.  This is just how DOS does file matching.  However, DOS
  768.      has a fatal flaw when matching filespecs to filenames:  all characters
  769.      following an asterisk in either part of the filename are ignored!  This
  770.      means that perfectly valid filespecs, such as *Z*.*,  which should find
  771.      all files containing a Z in the main part of the filename, actually find
  772.      every file in the directory, as if the filespec were *.*!  For example,
  773.      suppose the current directory contained the files BOOKS.TXT, BDN.EXE, and
  774.      HERES.DOC.  Using the filespec *s.* with ZDir would include the files
  775.      BOOKS.TXT and HERES.DOC, but the DOS DIR command would incorrectly
  776.      translate the filespec to *.* and include all three files, even BDN.EXE! 
  777.      ZDir's expanded wildcard capability corrects this mistake and uses the
  778.      correct interpretation of the wildcard characters.
  779.  
  780.      If no filespec was typed on the command line then ZDir uses *.* (all
  781.      files) as the file spec.  If the filespec contains an extension, such as
  782.      NONAME.WK1 or S*.H, then it uses the filespec exactly as specified on the
  783.      command line.  If the filespec ends in a period, then it matches all files
  784.      that match the "normal" part of the filename and have no extension.  If no
  785.  
  786.                                          10
  787.  
  788.  
  789.  
  790.  
  791.                              
  792.      
  793.  
  794.  
  795.  
  796.      extension or period are typed then ZDir adds wildcards depending upon how
  797.      it is configured.  If the option Default edit->Search options->Put *
  798.      before filespec is set to yes (expanded capability), then ZDir puts a *
  799.      before the filespec, and a *.* afterwards (e.g, Z becomes *Z*.*).  If it
  800.      is set to no (DOS compatibility), then only the trailing *.* is added
  801.      (e.g., Z becomes Z*.*).
  802.  
  803.      The chart below contains examples that illustrate many different scenarios
  804.      that commonly occur using ZDir.  Assume that the directory tree of drive
  805.      C: is as follows:
  806.                            C:\
  807.                             └───────┬─BIN
  808.                                     ├─BATCH
  809.                                     │   └───────TEMP
  810.                                     └─TEMP
  811.     ╔══════════════════════╦══════════╤════════════════════════╗
  812.     ║ Current directory:   ║          │                        ║
  813.     ║ C:\batch             ║          │                        ║
  814.     ╠══════════════════════╣ Setting  │                        ║
  815.     ║                      │ of Put * │                        ║
  816.     ║ Text on command line │ before   │ Path spec used by ZDir ║
  817.     ║                      │ filespec │                        ║
  818.     ╟──────────────────────┼──────────┼────────────────────────╢
  819.     ║ ZDir                 │ Yes, No  │ C:\batch\*.*           ║
  820.     ╟──────────────────────┼──────────┼────────────────────────╢
  821.     ║ ZDir C:\             │ Yes, No  │ C:\*.*                 ║
  822.     ╟──────────────────────┼──────────┼────────────────────────╢
  823.     ║ ZDir \               │ Yes, No  │ C:\*.*                 ║
  824.     ╟──────────────────────┼──────────┼────────────────────────╢
  825.     ║ ZDir D:\*.bat        │ Yes, No  │ D:\*.bat               ║
  826.     ╟──────────────────────┼──────────┼────────────────────────╢
  827.     ║ ZDir temp\all        │ Yes      │ C:\batch\temp\*all*.*  ║
  828.     ╟──────────────────────┼──────────┼────────────────────────╢
  829.     ║ ZDir temp\all        │ No       │ C:\batch\temp\all*.*   ║
  830.     ╟──────────────────────┼──────────┼────────────────────────╢
  831.     ║ ZDir C:wp.bat        │ Yes, No  │ C:\batch\wp.bat        ║
  832.     ╟──────────────────────┼──────────┼────────────────────────╢
  833.     ║ ZDir C:\batch\wp.bat │ Yes, No  │ C:\batch\wp.bat        ║
  834.     ╟──────────────────────┼──────────┼────────────────────────╢
  835.     ║ ZDir C:\bin\.exe     │ Yes, No  │ C:\bin\*.exe           ║
  836.     ╟──────────────────────┼──────────┼────────────────────────╢
  837.     ║ ZDir \temp\fdr       │ Yes      │ C:\temp\*fdr*.*        ║
  838.     ╟──────────────────────┼──────────┼────────────────────────╢
  839.     ║ ZDir \temp\fdr       │ No       │ C:\temp\fdr*.*         ║
  840.     ╟──────────────────────┼──────────┼────────────────────────╢
  841.     ║ ZDir \temp\fdr.001   │ Yes, No  │ C:\temp\fdr.001        ║
  842.     ╟──────────────────────┼──────────┼────────────────────────╢
  843.     ║ ZDir \bin\tempfile   │ Yes, No  │ C:\bin\tempfile.*      ║
  844.     ╟──────────────────────┼──────────┼────────────────────────╢
  845.     ║ ZDir \bin\tempfile.  │ Yes, No  │ C:\bin\tempfile        ║
  846.     ╟──────────────────────┼──────────┼────────────────────────╢
  847.     ║ ZDir .               │ Yes, No  │ C:\batch\*.*           ║
  848.     ╟──────────────────────┼──────────┼────────────────────────╢
  849.     ║ ZDir ..              │ Yes, No  │ C:\*.*                 ║
  850.     ╟──────────────────────┼──────────┼────────────────────────╢
  851.     ║ ZDir ..\*.com        │ Yes, No  │ C:\temp\*.com          ║
  852.     ╚══════════════════════╧══════════╧════════════════════════╝
  853.                                          11
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.      4.2.1 Displaying path specs
  866.  
  867.      If there is a volume label and serial number on the disk of the directory
  868.      listing, there may not be room on the screen for the complete path spec on
  869.      the left side of the second line of the display.  In these cases, the
  870.      first few directories of the path are replaced by a single \...\, such as
  871.      F:\USR\GROUP1\MICHAEL\WORK\DATA\123FILES\*.WK? being shortened to
  872.      F:\...\DATA\123FILES\*.WK?, where the \...\ replaced
  873.      \USR\GROUP1\MICHAEL\WORK.
  874.  
  875.  
  876.  
  877.      4.3 Volume information
  878.  
  879.      Every disk can have a volume label and a volume serial number.  The volume
  880.      label is a zero length file in the root directory on the disk that has the
  881.      volume label attribute set.  Unlike all other files, it is case sensitive,
  882.      and is just treated as an eleven character title.  To set the volume
  883.      label, type label from the DOS prompt.  To make a volume label with upper
  884.      and lowercase letters, a sector editor or a special volume label program
  885.      is needed.
  886.  
  887.      The serial number is a random eight digit hex number that is placed on the
  888.      disk when formatted by DOS version 4.0 or greater.  It helps DOS to
  889.      determine when one disk is removed from a floppy disk drive and another
  890.      one inserted.  It can also help people by being a unique identification
  891.      number.
  892.  
  893.      If either a volume label or a serial number is present on the disk ZDir
  894.      displays the information on the right side of the second line of the
  895.      display.
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.                                          12
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.      5. ZDir options
  932.  
  933.      Placing options on the command line alters the function of ZDir.  Many of
  934.      the options tell ZDir to perform a different operation than the usual
  935.      directory listing, including information options and the command options. 
  936.      These either have ZDir do something totally different than normal, such as
  937.      display a help screen, or just add to the normal function, such as
  938.      changing attributes.  There are also options to change features of the
  939.      display, such as the sort type and number of columns, which are called
  940.      display options.  All options are typed on the command line, starting with
  941.      a slash (/) and then the letter or characters describing the option.
  942.  
  943.  
  944.  
  945.      5.1 Information options
  946.  
  947.      The first class of options are those that tell ZDir to pop up information
  948.      screens instead of performing a directory listing.  These are /H, /?, and
  949.      /R.  The first of these options found on the command line is used, and all
  950.      other information on the command line is ignored.
  951.  
  952.      Two of these options, /H and /?, display the help screen for ZDir.  This
  953.      is a short page of information about how to run ZDir and a description of
  954.      every option.  Hitting Shift-Print Screen (or just Print Screen on 101/102
  955.      key keyboards) prints out the help screen on the printer.  Hitting any
  956.      other key quits the help screen and returns to DOS.
  957.  
  958.      The other information command option is /R.  This command displays an
  959.      order form for ZDir on the screen, which can be printed with Shift-Print
  960.      Screen (or Print Screen).  The form is identical to the one at the end of
  961.      this manual.  For more information on registering ZDir, see section 2
  962.      about Shareware, and section 7 for a registration form similar to the one
  963.      displayed with ZDir /R.
  964.  
  965.  
  966.  
  967.      5.2 Command options
  968.  
  969.      Command options that add on to the basic ZDir functionality are /L, /F,
  970.      /T, /U, and the attribute changing options, /+x or /-x, where x is one of
  971.      A, H, R, or S.  Each of these commands and associated options are
  972.      described below.
  973.  
  974.  
  975.  
  976.      5.2.1 Write to file
  977.  
  978.      ZDir always displays information on the screen, but using /L followed
  979.      directly by a filename tells ZDir to write another copy of its output to a
  980.      file.  Normally,  ZDir will display the message Writing to file filename,
  981.      and write out a text version of its output to the file.  To send the
  982.      output to the standard printer, use PRN as the filename.  ZDir will either
  983.  
  984.                                          13
  985.  
  986.  
  987.                                            
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.      send an exact copy of the output to the indicated file or substitute
  997.      pluses and dashes for the graphics characters depending on the setting of
  998.      the option Default edit->Output format->Graphics in alt. output.  This
  999.      option should be set to Standard ASCII when using printers that cannot
  1000.      print IBM extended graphics characters.
  1001.  
  1002.      The option /A, when put on the command line, writes out ANSI color codes
  1003.      to the file specified with /L.  This is useful when writing listings over
  1004.      the modem (/LAUX or /LCOM1).
  1005.  
  1006.      Several errors can occur when writing to files using /L.  If ZDir cannot
  1007.      write to the indicated file, then the message Error!  NOT writing to file
  1008.      filename is printed.  This can occur for several reasons:
  1009.  
  1010.      o    The file already exists.
  1011.  
  1012.      o    The file is a read-only device, such as the keyboard.
  1013.  
  1014.      o    There is a data error on the disk.
  1015.  
  1016.      o    The disk drive or directory does not exist.
  1017.  
  1018.      When an error occurs, just correct the problem and rerun ZDir.
  1019.  
  1020.      Several example runs are shown below:
  1021.  
  1022.      C:\>ZDir /Llist.txt *.*<Enter>
  1023.  
  1024.      This would write a copy of the file listing of all files in the current
  1025.      directory to the file LIST.TXT.
  1026.  
  1027.      C:\>ZDir *.exe /A /Lcom1<Enter>
  1028.  
  1029.      This would write a copy of the file listing of all files having the
  1030.      extension EXE to the first communications port including ANSI color codes.
  1031.  
  1032.      C:\>ZDir *.exe /Lprn<Enter>
  1033.  
  1034.      This would write a copy of the file listing of all files having the
  1035.      extension EXE to the standard printer.
  1036.  
  1037.      5.2.2 File find
  1038.  
  1039.      ZDir performs file finds quickly and easily using the option /F.  It
  1040.      displays a listing of the directory in the path specification and then
  1041.      goes to every directory below the specified directory and performs a
  1042.      listing, not printing anything if no files are found in a directory.  By
  1043.      specifying the root directory, ZDir will search an entire disk for files. 
  1044.      Example runs should clarify how to use file finding:
  1045.  
  1046.      C:\WORK>ZDir *.bat /F<Enter>
  1047.  
  1048.      This command tells ZDir to first display all files with the extension BAT
  1049.  
  1050.                                          14
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.      in the directory C:\WORK.  Next, ZDir goes to all the subdirectories of
  1063.      C:\WORK, and displays a listing of all files with the extension BAT in
  1064.      each directory under C:\WORK.
  1065.  
  1066.      C:\WORK>ZDir \*.bat /F<Enter>
  1067.  
  1068.      This command is the same as the previous one, but starts at the root
  1069.      directory, C:\, and displays a listing.  Then ZDir searches every
  1070.      directory on the disk for files with the extension BAT, and displays a
  1071.      file listing in each directory that has a file with the extension BAT.
  1072.  
  1073.      C:\WORK>ZDir /F /Lprn D:\<Enter>
  1074.  
  1075.      This command combines file finding with writing a listing to a file (see
  1076.      section 5.2.1).  ZDir will list every file on the D drive, displaying it
  1077.      on the screen and printing it on the printer.
  1078.  
  1079.  
  1080.  
  1081.      5.2.3 Tree display 
  1082.  
  1083.      Directory trees give an overall view of all or part of a disk in a compact
  1084.      format.  With ZDir, directory trees are printed where the file list is
  1085.      normally displayed.  Using the tree display option is similar to using the
  1086.      file find option, in that the path of the path spec is used as the first
  1087.      directory (top level of the tree), and then all the subdirectories are
  1088.      printed after it.  The tree does not have to start at the root directory;
  1089.      any directory can be selected to be the top level of the tree display. 
  1090.      The number of files that match the path spec and the sum of the file sizes
  1091.      of each directory (in kilobytes) are printed on the left.  Only files
  1092.      matching the filespec are included in the number of files count and total
  1093.      number of bytes count of each directory.  Up to five levels of directories
  1094.      below the top level are displayed.
  1095.  
  1096.      Unlike file finding, directories with no matching files are included, but
  1097.      a zero is listed under files and bytes.  The command to display a tree is
  1098.      /T.  Below is a sample run:
  1099.  
  1100.      C:\WORK>ZDir /T \WORK<Enter>
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.                                           15
  1117.  
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129. 8:15:50pm                    ZDir v2.0, by ZanySoft               March 2, 1992
  1130. Path: C:\WORK\*.*                                               Volume - WORK 2
  1131. ═══════════════════════════════════════════════════════════════════════════════
  1132.  
  1133. Files  Bytes Path
  1134.   15    160k WORK
  1135.   22     45k   └──────┬─WINPROG
  1136.   45    429k          ├─BACKUP
  1137.    4     94k          │    └──────WKS
  1138.   22    190k          └─WP
  1139.    8    129k             └──────┬─REPORT
  1140.   25    228k                    └─PERSONAL
  1141.  
  1142. ═══════════════════════════════════════════════════════════════════════════════
  1143. File listing of C:\WORK\
  1144.    and the 6 directories under it, of files of the form *.*
  1145. Totals --
  1146.     141 files totalling 1,319,529 bytes using 1,351,680 bytes of disk space.
  1147.  
  1148.  
  1149.      (Notice that there are no disk totals on this display, only the totals for
  1150.      the files.  This is not due to the tree, but due to the fact that the copy
  1151.      of ZDir that made the above display was configured to not print disk
  1152.      totals, using the Default edit->Output format->Disk totals option in
  1153.      ZDircfg.
  1154.  
  1155.  
  1156.  
  1157.      5.2.4 User extensions
  1158.  
  1159.      ZDir stores fifty extensions that it checks against each file, and colors
  1160.      the filename in the display the color associated with its extension. 
  1161.      Also, every extension is classified as either a user extension or not a
  1162.      user extension.  See section 6.2.3 for how to configure the extensions.
  1163.  
  1164.      User extensions allow you to designate up to fifty extensions that can be
  1165.      quickly displayed to the exclusion of other extensions.  When the command
  1166.      option /U is specified on the command line, only the files with extensions
  1167.      that are classified as a  user extension are listed--all other files are
  1168.      ignored.  (ZDir's factory default for the user extensions are EXE, COM,
  1169.      and BAT, so typing ZDir /U from the command line is a handy way to list
  1170.      all executable files in the current directory.)  An additional line is
  1171.      added after the file listing that tells you the current user extensions. 
  1172.      Any number of extensions can be made user extensions and are used to match
  1173.      against the files in the directory, and the first ten are displayed on the
  1174.      line following the file list area.
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.                                          16
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.      5.2.5 Attribute changing
  1196.  
  1197.      Every file has five attributes that tell DOS about the file.  Each of the
  1198.      five attributes are either on or off for every file.  ZDir can change all
  1199.      of the attributes except for the network attribute.
  1200.  
  1201.      The archive attribute is used with the DOS programs backup and restore, to
  1202.      determine which files have been newly modified since the last time backup
  1203.      was run.  The /+A command turns this attribute on for all files in the
  1204.      directory listing; the /-A command turns this attribute off for all files
  1205.      in the directory listing.
  1206.  
  1207.      The hidden attribute tells DOS to not list the file in DIR listings (ZDir
  1208.      can list all files, including hidden files--see section 6.2.5.1).  The /+H
  1209.      command turns this attribute on for all files in the directory listing;
  1210.      the /-H command turns this attribute off for all files in the directory
  1211.      listing.
  1212.  
  1213.      The system attribute is supposed to mean that the file is necessary to
  1214.      boot the computer, but all it really does is prevent the file from being
  1215.      run from the DOS prompt.  The /+S command turns this attribute on for all
  1216.      files in the directory listing; the /-S command turns this attribute off
  1217.      for all files in the directory listing.
  1218.  
  1219.      Files possessing the read-only attribute can not be written to or changed
  1220.      by DOS.  Making files read-only is a good way to prevent accidental
  1221.      deletions of important files.  The /+R command turns this attribute on for
  1222.      all files in the directory listing; the /-R command turns this attribute
  1223.      off for all files in the directory listing.
  1224.  
  1225.      The network attribute is used to identify whether a given file is
  1226.      shareable over a network.  It cannot be changed using ZDir.
  1227.  
  1228.  
  1229.  
  1230.      5.3 File listing options
  1231.  
  1232.      Although everything about ZDir can be configured using ZDircfg, there are
  1233.      times when you want to override the defaults for just one run of ZDir. 
  1234.      There are options that can be put on the command line to set the number of
  1235.      columns of the output, the sort type, and whether ZDir waits for a
  1236.      keypress between each screen of information.
  1237.  
  1238.      The options to set the number of columns on the command line are /1, /2,
  1239.      /3, /4, /6, and /W.  The number is the number of columns ZDir uses to
  1240.      display the directory listing, with /W the same as /6.  Section 4.1
  1241.      describes what the display looks like for each number of columns.
  1242.  
  1243.      The available sort options are /N, /X, /Z, /D, and /S.  They stand for
  1244.      sort by name, extension, size, date and time, and no sort, respectively. 
  1245.      When there is no sort, the files are listed in the same order as the DOS
  1246.      DIR command.  When there is no sort, the setting of Default edit->File
  1247.  
  1248.                                          17
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.      list choices->Directory placement is ignored and directories are placed
  1262.      together with files.  This makes the list of filenames and directories
  1263.      appear in the exact same order as the DOS DIR command.
  1264.  
  1265.      The /K option toggles the default of waiting for a key between each screen
  1266.      of data.  For example, if the default is to wait for a key each screen,
  1267.      then typing /K on the command line will make ZDir not wait for a key each
  1268.      screen.  This is useful when writing a listing to a file or to the printer
  1269.      because ZDir will not pause during the entire run.  Regardless of the
  1270.      setting of this option, the Press any key to continue message does not
  1271.      appear in the file output.
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.  
  1293.  
  1294.  
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.                                          18
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.      6. Configuration:  ZDircfg
  1328.  
  1329.      The most exciting part of ZDir is that every color, extension, and option
  1330.      is configurable with an easy to use companion program, ZDircfg.  ZDircfg
  1331.      is a menu driven program that presents configuration information in the
  1332.      menus.  It loads and saves the configuration info in the executable
  1333.      program ZDir.com itself.  When ZDircfg is run, it starts with "factory
  1334.      settings" for every option which are identical to the configuration in
  1335.      ZDir.com when you received it.  If at some future date you wish to restore
  1336.      the "factory settings" to a copy of ZDir, just run ZDircfg and immediately
  1337.      save to a copy of ZDir.com.  ZDircfg also allows registered users to
  1338.      incorporate settings they have established in previous versions of ZDir
  1339.      into the latest version by loading in the settings from the old version
  1340.      and saving to the new version.
  1341.  
  1342.  
  1343.  
  1344.      6.1 Using ZDircfg
  1345.  
  1346.      ZDircfg is easy to use because it is menu driven.  The initial layout of
  1347.      ZDircfg has a title line at the top of the screen, the top level menu in
  1348.      the upper left of the screen, and the help line on the bottom.  The help
  1349.      line shows several of the most important keys for the current situation,
  1350.      but due to space limitations it does not have all of them.
  1351.  
  1352.      In every menu, the current menu item is in a different background color,
  1353.      which is called the cursor.  To move the cursor up or down one choice, hit
  1354.      the up or down arrow keys.  To go to the first menu choice, hit page-up. 
  1355.      To go to the last menu choice, hit page-down.  To select the current menu
  1356.      item, hit <Enter> or the space bar.  To select a menu item other than the
  1357.      current item, hit the fast key, usually the first letter of the item. 
  1358.      This letter, called the fast key, is in a different color than the rest of
  1359.      the text.  To abort the current choice or to go back up a menu, hit the
  1360.      escape key.  From the top level menu, this will quit ZDircfg if no changes
  1361.      have been made, or, if changes were made, ask you if you want to quit and
  1362.      lose the changes.
  1363.  
  1364.      There are several different types of menu entries, including submenus,
  1365.      color choices, pick from a list, and other functions.  Submenus are
  1366.      indicated by a   character on the right of the entry.  These contain an
  1367.      additional menu, which are of a similar function.  Color choices have the
  1368.      word Sample on the right of the entry, in the current color of the option. 
  1369.      Pick from a list menu items have a short description of the current choice
  1370.      on the right of the entry, which can be changed with the left and right
  1371.      arrow keys, as well as <Enter> and the space bar (which are the same as
  1372.      right arrow).  Many of the pick from a list menu items are yes or no
  1373.      questions.  Other menu items perform various functions: these include
  1374.      quitting ZDircfg, popping up a window to load or save configuration
  1375.      information, editing the extensions, and setting the column auto-detection
  1376.      amounts.  These menu choices are indicated by three periods(...) after the
  1377.      choice.
  1378.  
  1379.  
  1380.                                          19
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.      6.2 ZDircfg menus
  1395.  
  1396.      The main menu of ZDircfg looks like the following:
  1397.  
  1398.      ┌──────────────────────────────┐
  1399.      │ Load ZDir configuration...   │
  1400.      │ Save ZDir configuration...   │
  1401.      │ Extension edit...            │
  1402.      │ Color edit                  │
  1403.      │ Default edit                │
  1404.      │ Registration form...         │
  1405.      │ Quit                         │
  1406.      └──────────────────────────────┘
  1407.  
  1408.      The first two selections load and save configuration information to and
  1409.      from one or more copies of ZDir.  Extension edit pops up a window that
  1410.      allows setting of the fifty extensions and corresponding colors with which
  1411.      to display files matching these extensions, and setting whether each is a
  1412.      user extension or not.  Color edit and Default edit are submenus
  1413.      containing the settings of every color and default of ZDir.  The selection
  1414.      Registration form displays the same registration form as when ZDir /R is
  1415.      run.  The last menu selection, Quit,  exits ZDircfg, but if any changes
  1416.      have been made and were not saved, it asks if you are sure.
  1417.  
  1418.  
  1419.  
  1420.      6.2.1 Load ZDir configuration
  1421.  
  1422.      Loading in configuration information from a copy of ZDir on disk is the
  1423.      first step in configuring ZDir.  If the copy of ZDir you are loading from
  1424.      is prior to version 2.0, then ZDircfg pops up a window asking for your
  1425.      registration name and number, because upgrading config info from an old
  1426.      version to the current version 2.0 is only available to registered users.
  1427.  
  1428.      When the main menu option Load ZDir configuration is selected, ZDircfg
  1429.      draws a small text input window on the screen with the prompt Enter ZDir
  1430.      filename.  You must type in the path to the copy of ZDir for ZDircfg to
  1431.      load.  If the copy of ZDir to load is in the current directory, then only
  1432.      the filename is required.  Note that ZDir does not have to be called
  1433.      ZDir.com.  Many users shorten it (using the DOS REN command) to ZD.com or
  1434.      Z.com for ease of typing.  ZDircfg automatically adds .COM to the end of
  1435.      the filename if you do not type the extension.
  1436.  
  1437.      Several keys have special functions when typing filenames in ZDircfg.  The
  1438.      left and right arrow keys move the cursor left and right in the filename. 
  1439.      Delete deletes the character at the cursor (or does nothing if the cursor
  1440.      is at the end of the filename).  Backspace deletes the character to the
  1441.      left of the cursor.  Home and end move the cursor to the beginning and end
  1442.      of the filename, respectively.  To toggle between inserting characters and
  1443.      overwriting text, hit the insert key.  The status of insert mode is
  1444.      indicated by the cursor.  It is a full block in overwrite mode, and an
  1445.  
  1446.                                          20
  1447.  
  1448.  
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.      underline in insert mode.
  1460.  
  1461.      The maximum length of the path and filename to ZDir is 60 characters. 
  1462.      Once the entire filename is typed in, hit <Enter>.  If ZDircfg
  1463.      successfully loads in configuration information from ZDir, it pops up a
  1464.      window that says Loaded ZDir version x.y, where x.y is the version of ZDir
  1465.      it loaded from.  If there was a problem loading ZDir, ZDircfg displays an
  1466.      error window that describes the problem and then returns to the main menu. 
  1467.      If the version of ZDir you are trying to load is less than 2.0, then you
  1468.      are trying to upgrade information from one version to another, and ZDircfg
  1469.      displays a window asking you for your registration name and number.  Type
  1470.      your registration name and number exactly as printed on the letter you
  1471.      received as acknowledgement of your registration.  The case of letters is
  1472.      significant, and should all be uppercase.  Also, if there are any extra
  1473.      spaces ZDircfg will not load the old configuration information, so be sure
  1474.      to type the registration name and number carefully.
  1475.  
  1476.      Filenames entered to attempt to load ZDir, whether successful or not, are
  1477.      saved (in the current session of ZDircfg) for the next time you try to
  1478.      load ZDir from disk.  When you enter Load ZDir configuration again, the
  1479.      text is displayed in a different color.  To use the text, hit any of the
  1480.      special keys (left and right arrow, home and end, backspace, and enter),
  1481.      or hit any other key to restart with a new filename.  This can save a lot
  1482.      of typing if you are getting errors trying to load in ZDir.
  1483.  
  1484.  
  1485.  
  1486.      6.2.2 Save ZDir configuration
  1487.  
  1488.      Saving the current configuration information to a copy of ZDir 2.0 looks a
  1489.      lot like loading info from ZDir, and is in fact very similar.  When you
  1490.      pick this menu selection from the main menu, a small text window is popped
  1491.      up and you are asked to enter the filename of the copy of ZDir where you
  1492.      want to save the configuration info.  The editing keys are the same as
  1493.      with loading ZDir.  Unlike loading from ZDir, however, configuration info
  1494.      can only be saved to ZDir version 2.0, and ZDircfg will give an error if
  1495.      you try to save to a different version of ZDir.
  1496.  
  1497.  
  1498.  
  1499.      6.2.3 Extension editing
  1500.  
  1501.      Selecting the extension edit choice on the main menu opens a window that
  1502.      shows all fifty extensions, each in its extension color, and indicates
  1503.      which ones are designated user extensions.  When ZDir is run, each
  1504.      filename is checked against the extensions, and if the filename's
  1505.      extension matches one of the fifty extensions, then it is displayed in the
  1506.      designated color for that extension.  Wildcards are allowed anywhere in
  1507.      the extensions, making grouping of files by color very easy.
  1508.  
  1509.      Editing the extensions themselves is a simple matter.  The horizontal
  1510.      arrow keys move one letter at a time through the extension, and the
  1511.  
  1512.                                          21
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.      vertical arrow keys move between extensions.  Tab and shift-tab move
  1526.      forward or backward one extension.  Home and end move to the beginning and
  1527.      end of the row; page-up and page-down move to the top and bottom of the
  1528.      column.  To change the character at the cursor, simply type a valid
  1529.      filename character (any letter, number, or certain special characters). 
  1530.      The new character overwrites the old.  There is no insert mode.  For
  1531.      extensions less than three characters long, delete and backspace remove
  1532.      characters.  The space bar does not put a space in the extension, because
  1533.      it is used with setting user extensions.
  1534.  
  1535.      When ZDir is run with the /U option, the only files included are those
  1536.      that match extensions designated "user extensions".  These are shown in
  1537.      the extension edit window by a check mark to the right of the extension
  1538.      name.  The space bar toggles whether the extension at the cursor is a user
  1539.      extension or not.
  1540.  
  1541.      To edit the color of the extension at the cursor, hit the <Enter> key. 
  1542.      This causes a color selection box to be displayed to the right of the
  1543.      extension, with the white line cursor surrounding the current color of the
  1544.      extension.  The vertical arrow keys change the foreground color and the
  1545.      horizontal arrow keys change the background color.  Home and end move the
  1546.      cursor to the left and right of the color selection box.  Page up and page
  1547.      down move the cursor to the top and bottom of the box.  To set the
  1548.      extension to the color at the cursor, hit <Enter>.  To abort the color
  1549.      entry and retain the previous color, hit escape.
  1550.  
  1551.      When you are done editing the extension information, hit the escape key to
  1552.      return to the main menu.  Any changes you made will be retained in memory,
  1553.      for further editing later or saving to a copy of ZDir.
  1554.  
  1555.  
  1556.  
  1557.      6.2.4 Color editing
  1558.  
  1559.      The color edit menu contains several submenus that contain the colors for
  1560.      the display of everything other than the filename that can be configured. 
  1561.      The menu looks as follows:
  1562.  
  1563.      ┌──────────────────────┐
  1564.      │ Header lines        │
  1565.      │ File entry area     │
  1566.      │ Summary lines       │
  1567.      │ Tree display        │
  1568.      │ Miscellaneous       │
  1569.      └──────────────────────┘
  1570.  
  1571.      Each of the submenus contains the colors that may be configured for a
  1572.      particular part of ZDir's display.  The header lines colors are the colors
  1573.      of the current time and date, the text indicating the path and volume
  1574.      label, and the ZanySoft message.  The ZanySoft message is ZDir v2.0 by
  1575.      ZanySoft.  For the two colors of the ZanySoft message only, the foreground
  1576.      is not allowed to be the same as the background.
  1577.  
  1578.                                          22
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.      The file entry area is everything that ZDir displays within the graphic
  1592.      lines (except for trees).  This includes the time and date of each file,
  1593.      file sizes and used disk space, file attributes, directories, volume
  1594.      labels, hidden files, and the graphic lines themselves.  The color of
  1595.      files that match no extension is also in the file entry area menu.
  1596.  
  1597.      The summary lines give the totals for the ZDir run and are displayed in up
  1598.      to three different colors.  The first summary color is the color of the
  1599.      message displayed directly after the file area when the /U option is used
  1600.      which says Files matching extensions followed by the extensions in their
  1601.      own colors.  The other two colors are for the text of the summary lines,
  1602.      and the numbers and the path spec in the summary lines.
  1603.  
  1604.      The miscellaneous color menu has the colors that do not fit into any other
  1605.      category.  The most important of these is the empty space color, which is
  1606.      the color of most of the spaces in the ZDir listing.  Since only spaces
  1607.      are printed in this color, the foreground part of the empty space color
  1608.      does not matter.  Usually you will want this to be black, but if you set
  1609.      your background color in DOS to another color (using ANSI escape
  1610.      sequences, for example), then you can set ZDir to match it.  The other
  1611.      miscellaneous colors are the two colors for the press any key to continue
  1612.      message in between each screen of data, the no files found message color,
  1613.      and the color of the message giving the status of writing to a file (when
  1614.      /L is on the command line).
  1615.  
  1616.  
  1617.  
  1618.      6.2.5 Default editing
  1619.  
  1620.      The default edit menu opens up a submenu that categorizes the configurable
  1621.      defaults into three groups:
  1622.  
  1623.      ┌────────────────────────┐
  1624.      │ Search options        │
  1625.      │ File list choices     │
  1626.      │ Output format         │
  1627.      └────────────────────────┘
  1628.  
  1629.      Each of these submenus contains several options, and is discussed
  1630.      separately.
  1631.  
  1632.  
  1633.  
  1634.      6.2.5.1 Search options
  1635.  
  1636.      The search options all deal with how ZDir chooses which files to list. 
  1637.      Depending on how they are set, ZDir can include many more files than the
  1638.      standard DOS DIR command, or show the same files as the DOS DIR command
  1639.      would.  The search options menu appears on the screen as follows:
  1640.  
  1641.  
  1642.                                               
  1643.  
  1644.                                          23
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.      ┌───────────────────────────────────────┐
  1656.      │ Put * before filespec             Yes │
  1657.      │ Add directory entries in totals    No │
  1658.      │ Show . and .. files               Yes │
  1659.      │ Include:  Hidden files            Yes │
  1660.      │           Read only files         Yes │
  1661.      │           System files            Yes │
  1662.      │           Volume labels           Yes │
  1663.      └───────────────────────────────────────┘
  1664.  
  1665.  
  1666.      In every run ZDir adds *.* to the end of the filespec if there is no
  1667.      extension specified, but the Put * before filespec selection determines
  1668.      whether ZDir also adds a * to the beginning of the filespec as well.  For
  1669.      example, with this option set to no, then the command
  1670.  
  1671.      C:\>ZDir abc<Enter>
  1672.  
  1673.      tells ZDir to use abc*.* as the filespec.  If it is set to yes, ZDir will
  1674.      use *abc*.* as the filespec.  See section 4.2 for more about filespecs.
  1675.  
  1676.      The next two search options are related:  add directory entries in totals
  1677.      and show . and .. files.  If ZDir does not add directories to totals, then
  1678.      the total lines give a count of actual files and their total space.  If
  1679.      ZDir does add directories in the totals, then the total number of files
  1680.      includes directory entries, and the total space accurately shows how much
  1681.      disk space is used by every listed directory entry.  Every directory on a
  1682.      disk except for the root directory contains two directory entries, called
  1683.      . and .., which help DOS keep track of the directory.  ZDir will not show
  1684.      these two directory entries if Show . and .. files is set to no.
  1685.  
  1686.      The last four search options tell ZDir what attributes a file may have and
  1687.      still be listed by ZDir.  Normally, all four are set to yes so that ZDir
  1688.      shows every file in the directory.  The DOS DIR program does not include
  1689.      files with any of the four attributes, which are hidden, read-only,
  1690.      system, and volume label.  Running ZDir under the DR DOS operating system
  1691.      restricts the options slightly, in that DR DOS ignores files with the
  1692.      volume label attribute, so the setting of the volume label option does not
  1693.      matter because files with the volume label attribute can never be listed.
  1694.  
  1695.  
  1696.  
  1697.      6.2.5.2 File list choices
  1698.  
  1699.      The file list choices affect the look of the center part of the actual
  1700.      file listing.  The main choices are the number of columns and the sort
  1701.      used, but several other options affect the file list as well.  The file
  1702.      list choices menu is shown below:
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.                                          24
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.      ┌─────────────────────────────────────────────┐
  1724.      │ Number of columns               Auto detect │
  1725.      │ Auto detect settings...                     │
  1726.      │ Sort ordering                 Top to bottom │
  1727.      │ Directory placement        Before all files │
  1728.      │ Entire entry in file color               No │
  1729.      │ 1st sort factor                        Name │
  1730.      │ 2nd sort factor                        Name │
  1731.      │ 3rd sort factor                        Name │
  1732.      │ 4th sort factor                        Name │
  1733.      └─────────────────────────────────────────────┘
  1734.  
  1735.      The number of columns that ZDir uses to display the listing is the choice
  1736.      that affects the ZDir display the most.  The choices are 1, 2, 3, 4, 6, or
  1737.      auto detect.  If it is set to auto detect mode, then ZDir uses the auto
  1738.      detect settings to choose how many columns to use.  For a description
  1739.      about the benefits and drawbacks of each choice, see section 4.1.
  1740.  
  1741.      The auto detect settings menu entry opens up into a window which shows the
  1742.      range of the number of files for which ZDir will select 1, 2, 3, 4, or 6
  1743.      column display mode.  The cursor is on the righthand side of the window,
  1744.      highlighting the upper limit of the range.  The vertical arrow keys, page
  1745.      up, and page down move the cursor up and down to the different columns'
  1746.      ranges.  The right and left arrow keys change the upper limit of the range
  1747.      by one, and the plus and minus keys change the upper limit by ten.  When
  1748.      one range is changed, the others are adjusted to prevent overlapping
  1749.      ranges.  The maximum number of the lower part of the six column range is
  1750.      255.  If a change would push the six column range over 255 or the one
  1751.      column range below zero, the change is ignored.
  1752.  
  1753.      There are two ways to display a directory listing when there are multiple
  1754.      columns:  left to right or top to bottom.  This is the choice of the sort
  1755.      ordering option.  If it is set to left to right, then the first filename
  1756.      is printed in the top of the first column, the second is in the top of the
  1757.      second column, etc.  If it is set to top to bottom, then the first file is
  1758.      still in the top of the first column, but the next file is just below it
  1759.      in the first column.  The DOS DIR command uses left to right ordering, but
  1760.      most people find top to bottom ordering easier to read.
  1761.  
  1762.      Although subdirectories are listed together with files in directory
  1763.      listings, they are quite different from normal files and should be treated
  1764.      differently.  The directory placement option gives you the capability to
  1765.      separate directories from normal files, by either placing the
  1766.      subdirectories before or after the normal files.  When files are displayed
  1767.      in the DOS file order (no sort), then this option is ignored, because in
  1768.      the DOS file order directories are always interspersed among the files.
  1769.  
  1770.      Having each type of information about a file displayed in different colors
  1771.      can be distracting to some people when looking at the directory listing
  1772.      line by line, especially in one or two column mode.  For easier
  1773.      recognition of a file's information, the entire file entry can be
  1774.      displayed in the filename's color (determined by its extension).  Although
  1775.  
  1776.                                          25
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.      for certain applications this is helpful, for most of the time the Entire
  1790.      entry in file color should be set to no.
  1791.  
  1792.      The order in which files are listed is determined by the sort.  The DOS
  1793.      DIR command does not have any sort, and instead displays the files in the
  1794.      order it gets the filenames from disk.  This is one option for the sort in
  1795.      ZDir, called the DOS file order.  The other options are name, extension,
  1796.      size, date, and time.  All of the sort options, except the DOS file order,
  1797.      can also be set to sort in reverse order.  If files are tied after the
  1798.      first sort (for example, if sorting by date, they have the same date),
  1799.      then the secondary sort is used to break the tie.  If they are still tied,
  1800.      then the third sort is used, etc.  Usually only the first two or three
  1801.      factors are all that are important, however in some cases the fourth is
  1802.      needed.  Sorting by the DOS file order is only available as the first sort
  1803.      factor, because it is only needed to show files in the same order as DOS,
  1804.      and would be pointless as a tie breaker.
  1805.  
  1806.  
  1807.  
  1808.      6.2.5.3 Output format
  1809.  
  1810.      The options in the output format menu deal with how the output of ZDir is
  1811.      presented.  This menu looks as follows:
  1812.  
  1813.      ┌──────────────────────────────────────────────┐
  1814.      │ Screen writes                           Fast │
  1815.      │ Clear screen to start                     No │
  1816.      │ Graphics in alt. output         IBM extended │
  1817.      │ Wait for keypress each screen            Yes │
  1818.      │ Use commas in file size                   No │
  1819.      │ Print a . before extensions               No │
  1820.      │ Disk totals                           Always │
  1821.      └──────────────────────────────────────────────┘
  1822.  
  1823.      The screen writes option tells ZDir how to write to the screen.  The
  1824.      options are fast and BIOS.  Except for users of old CGA cards, it should
  1825.      normally be set to fast screen writes.
  1826.  
  1827.      Clearing the screen to start the display makes ZDir run much faster,
  1828.      because the slowest part of ZDir is scrolling the screen.  If you want to
  1829.      make ZDir as fast as possible, set Clear screen to start to yes, and the
  1830.      display will start at the top of the screen.
  1831.  
  1832.      The third option affects the output when writing to file (see section
  1833.      5.2.1).  If it is set to IBM extended, then an exact copy of the ZDir
  1834.      output is written to the file specified with /L.  If it is set to standard
  1835.      ASCII, then characters such as -, |, and + are substituted for the graphic
  1836.      lines characters.
  1837.  
  1838.      ZDir will wait for a keypress in between each screen of information when
  1839.      the wait for keypress each screen is set to yes.  If it is set to no, then
  1840.      ZDir will not wait for a key at any time, and complete its listing without
  1841.  
  1842.                                          26
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.      pausing.  This option can be toggled for one run by placing /K on the
  1856.      command line.
  1857.  
  1858.      Although there is plenty of room in one column mode for commas in file
  1859.      sizes, when multiple columns are displayed it is a bit of a stretch, as
  1860.      there is not room for commas in six digit numbers.  The commas in file
  1861.      sizes option gives you the choice of using commas in file sizes, when
  1862.      there is room.  The numbers in the total lines at the end are always
  1863.      displayed with commas for easier reading, and this option does not affect
  1864.      them.
  1865.  
  1866.      Filenames are displayed in two parts, the up-to-eight character normal
  1867.      part of the name, padding spaces, and then the up-to-three character
  1868.      extension.  The Print a . before extensions option determines whether a
  1869.      period character is printed instead of the last padding space before the
  1870.      extension.
  1871.  
  1872.      The last line in the ZDir display is the disk totals line, which shows how
  1873.      many bytes are free on the listed disk drive, and the total amount of data
  1874.      it can hold.  Since this is useless to some people, the disk totals option
  1875.      allows you to set ZDir to not display the disk totals, to only display the
  1876.      disk totals when doing a listing from either A: or B:, or to always
  1877.      display disk totals.
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.                                          27
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.      7. Registration form
  1922.  
  1923.  
  1924. Name           _______________________________________________________________
  1925.  
  1926. Street Address _______________________________________________________________
  1927.  
  1928. City           ______________________________________ State _____ Zip ________
  1929.  
  1930. Where did you get ZDir? ______________________________________________________
  1931.  
  1932.  
  1933.                            ZanySoft Dir, version 2.0
  1934.  
  1935.           Remember, if you use ZDir, you are obligated to pay for it.
  1936.  
  1937. ___ $10   I am registering ZDir for use on one computer.  Please send me my
  1938.           registration number so I can upgrade configuration colors and
  1939.           defaults to all future versions of ZDir.
  1940.  
  1941.        Registration name, no more than 25 characters: _________________________
  1942.  
  1943.     The following three items do NOT include registration:
  1944.  
  1945. ___  $5   I would like a 3.5" disk with the current version of ZDir.
  1946.  
  1947. ___  $5   I would like a 5.25" disk with the current version of ZDir.
  1948.  
  1949.     The following is for registered users ONLY:
  1950.  
  1951. ___  $5   I would like the laser printed version of the manual.
  1952.  
  1953.  
  1954. _______ Total. Enclose cash or a check drawn on US currency made out to
  1955.                Christopher Kirmse.  Send this form and payment to:
  1956.  
  1957.                     ZanySoft
  1958.                     9303 Arabian Ave.
  1959.                     Vienna, VA  22182
  1960.  
  1961. Write any comments below
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.                                        28
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.